MESA LANGUAGE MANUAL - 
CHANGED CHAPTERS 


The changes to the Mesa Language for Mesa 14.0 are: 

New options for machine-dependent record declarations. 

Changes that result from allocating global frames from 
outside the main data space (MDS). The Mesa 14.0 compiler 
can produce code in which global frames are allocated in 
the MDS if the 'o switch (meaning old code) is used. With 
this switch, these changes do not apply. 


3 Common constructed data types 


3.3.7 Machine dependent records 


The syntax for machine-dependent record declarations has 
been extended to facilitate writing portable Mesa code. One 
can now specify: 

The size of the unit for the word part of a field 
specification (e.g. the unit for 2 in (2:0..15)). 

Whether bit 0 of a word refers to the most significant bit or 
the least significant bit 

The syntax is: 

dependentRec :: = 

BitNumOption UnitOption machine dependent record 
UnitOption BitNumOption machine dependent record 
BitNumOption machine dependent record | 

UnitOption machine dependent record | 
machine dependent record | empty 

BitNumOption ::= msbit| lsbit | native 
UnitOption : : = words | wordi6 | WORD32 

Examples: 

TV . TYPE = MSBITWORD16 MACHINE DEPENDENT RECORD [...]; 

T2‘. TYPE = W0RD8NATIVE MACHINE DEPENDENT RECORD [...]; 
ra: TYPE = W0RD32MACHINEDEPENDENTREC0RD[...]; 

The UnitOption defines the unit size for the word part of a 
field specification. TheBitNumOption (msbit/lsbit) controls how 
the bits are numbered within a word of the size specified in the 
UnitOption. For example, if the UnitOption is words then bit 2 
in an msbit declaration becomes bit 5 if the declaration is 
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rewritten as an lsbit declaration. If the UnitOption is WORD32, 
however, then bit 2 in an msbit declaration becomes bit 29 if 
the declaration is rewritten as an lsbit declaration, native 
means whichever bit numbering is native to the target 
architecture (msbit for PrincOps). 

If the BitNumOption or the UnitOption is omitted, then the 
defaults are native WORD16, which are backwards compatible. 

Restrictions: 

With this definition of msbit/lsbit certain restrictions apply 
when the BitNumOption is not the native (default) bit 
numbering for the machine (e.g., not msbit on PrincOps 
machines). These restrictions are in addition to the restrictions 
regarding record size and field alignment. 

When using the non-native BitNumOption, it is possible to 
declare records in which the bit numbers for a field are all 
contiguous, but the field would actually be split into two parts. 
Such declarations are illegal. The following declaration, for 
example, is NOT legal for PrincOps. 

r. TYPE = LSBIT W0RD8 MACHINE DEPENDENT RECORD [ 

n(0:0..14): natural, 

fc>(1:7..7): BOOLEAN]; 

Field n of this type would occupy the entire first byte of the 
record, and the least significant 7 bits of the second byte, thus 
leaving the most significant bit of the second byte as a gap in 
the field (filled in by field b), as shown in Figure 3-1. 


byte 0 

byte 1 

7 0 

7:6 0 

-n- 

b j-n- 


Figure 3-1 


MSBIT WORD8 
numbering 


This declaration is legal, however, on a machine in which lsbit is 
the native bit numbering. 

The following similar declaration, using WORD16, is legal even 
on machines whose native bit numbering isMSBiT. 

r: TYPE = LSBIT WORD16 MACHINE DEPENDENT RECORD [ 

n(0:0.. 14): natural, 
b( 0:15..15): BOOLEAN]; 


1-2 
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In this case, the bit numbering is reversed (from the native bit 
number) for the entire 16-bit word, as shown in figure 3.2. 


byte 0 

byte 1 


15|14 


0 

b i - 

-n- 



Figure 3-2 


MSBIT W0RD16 
numbering 


The general rule for insuring that a field is not split is: 

If the non-native bit numbering option is used, and n is the 
number of bits specified in the unit option (i.e. WORDn), 
then: 

1) a field smaller than an n-bit word can not cross an n-bit 
word boundary. 

2) a field occupying more than an n-bit word must begin 
at bit zero of an n-bit word and its size must be a 
multiple of n bits. 

A declaration containing a split field will generate the error 
message: 

< fieldname> is a split field 

To avoid gaps in a record, when the non-native BitNumOption 
is used, the total length of the record must be a multiple of the 
length specified in the UnitNumOption. For example, on a 
machine whose native bit numbering is msbit (e.g,. PrincOps), 
the following declaration has a gap. 

T: TYPE = LSBITW0RD16 MACHINE DEPENDENT RECORD [ 

c7(0:0..7),c2(0:8..15),ci(1:0..7): character]; 

When rewritten with msbit notation, the gap becomes more 
evident. 

T: TYPE = MSBIT W0RD16 MACHINE DEPENDENT RECORD [ 

c/(0:8..15), c2(0:0..7), ci(1:8.. 1 5): character]; 

For variant records, if there is a tag field then it must be the 
first field in the variant part of the record. When using the non¬ 
native BitNumOption, extra care must be taken to insure this 
requirement is met. In the following declaration, the tag field 
is not the first field in the variant part of the record, but rather 
is between the two fields of each variant if the target machine 
is PrincOps. 

Tl TYPE = LSBITWORD16 MACHINE DEPENDENT RECORD [ 

var/ant(0:0..31 ): SELECT tag{ 0:0..0) FROM 

al = > [n(0:1..15): NATURAL, /(1:0..1 5): integer]. 
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a 2 = > [n(0:1.. 15): NATURAL, c(1:0.. 1 5): CARDINAL], 
endcase]; 


3.4 The types POINTER and LONG POINTER 


Since Global frames do not reside in the main data space 
(MDS), short pointers can not be used to indirectly access 
global variables. 


3.4.2 String literals and string expressions 


The example at the bottom of page 3-34 is no longer legal. 
When applied to a global variable, the @ operator returns a 
long pointer type. In this example, the variables pointerl, and 
pointer2 must be decalred as long pointer to integer. 


6 Other data types and storage management 


6.1.1 String literals and string expressions 


A string literal allocated in the global frame can be assigned 
only to a long string. Similarly, a global string literal can not be 
passed as an actual parameter to a procedure whose formal 
parameter is a short string. 


6.1.2 Declaring strings 


A string that points to a stringBody allocated in a global frame 
must be a long string. The following string initialization: 

s: string «- [30]; 

is allowable only inside a procedure, not in the mainline code 
(unless it is within a nested block in the mainline code). 


6.2.1 Array descriptor types 


A descriptor for an array in the global frame must be a long 
descriptor. When applied to a global array, the descriptor 
operator can only yield a long descriptor type. 
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GENERAL TOOLS 


4 

Executive 


4.2.2 Command interface 


CacheAddress maintains the network address cache that is used 
with the AddressTranslation interface. CacheAddress allows 
one to create, list, load, store, and manage the network address 
cache. 


The command syntax is: 


>CacheAddress command/arg command/arg 


Command/Arg 

SetSize/n 

GetSize 

Flush 

List 

Certify/entry 

Load/file 

Store/file 

Statistics 


address cache size is set to n. 
returns address cache size, 
flushes the content of the cache, 
size remains the same, 
lists contents of the cache, 
certifies entry in clearinghouse, 
entry may contain ’* 
loads contents of file into cache, 
stores contents of cache into file, 
lists local statistics. 


CacheAddress SetSize/20 List Store/£oo.cache 
Creating cache files 

To set up your machine to use CacheAddress, do the following: 

1. Type into the Executive: 

>CacheAddress SetSize/20 

This will set the size of the cache to 20. 

2. Run for a day with this cache. The first time you lookup a 
machine address, it will be placed into the cache. To see the 
cache at any point, type into the Executive: 

>CacheAddress List 

3. After running CacheAddress for awhile, create a cache file 
by the command: 
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>CacheAddress Store/< >Address.cache 

This will place the current contents of the cache into the file 
Address.cache. 

4. At this point, place into your user.cm InitialCommand: 
section: 

[System] 

InitialCommand: ...; CacheAddressSetSize/20 
load/Address.cache;... 

Certifying your address cache 

At some point your address cache may become invalid because 
an address in the clearinghouse has changed. To validate your 
entire current address cache, type: 

>CacheAddress Certify 

This will cause all entries in your cache to be validated. If you 
wish only to certify a single entry (Goofy), use : 

>CacheAddress Certify/"Goofy:OSBU North:Xerox" 

OR 

>CacheAddress Certify/Goofy 

Patterns can also be used to certify entries. ‘* will match zero or 
more of any letter, and '# will match any single character. 
Make sure to quote the asterisk in the Executive, otherwise it 
will match files on your disk. 

>CacheAddress Certify/G'* (this will certify all name 
starting with ’O') 

If you keep your address cache stored in a file, you will want to 
update you cache file after doing a Certify. Example: 

>CacheAddress Store/address.cache 


13 Compare 


Compare will now correctly compare files on a remote NS File 
Server. 
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III 

SYSTEM BUILDING TOOLS 


19 Compiler 


With Pilot 14.0, global frames are not allocated from the main 
data space (MDS). This architectural change causes some small 
semantic changes to the Mesa language. These language 
changes are documented in the Mesa Language Manual 
Change Summary. 


19.2.2 Switches 


The Mesa 14.0 compiler now has an /o switch, which causes the 
compiler to generate code for pre-Mesa 14.0. When this 
switch is used, the compiler will create a module with a global 
frame in the MDS. The restrictions noted in the Mesa Language 
Change Summary for Mesa 14.0 do not apply if this switch is 
used. 

The default for the /o switch is false. 


21 MakeBoot 


With Pilot 14.0, MakeBoot changed to reflect the new 
architecture. In addition, MakeBoot now uses the runtime 
loader in Pilot to load the input object files. Because of the 
differences in the Pilot runtime loader and the old MakeBoot 
loader, there are some new restrictions. 

The new restriction with MakeBoot is all input object files must 
be bound with their code. With the pre 14.0 MakeBoot, the 
object files could be bound without code (the /-c switch in the 
Binder), and MakeBoot would search the disk for the object file 
that contains the code. Since the Pilot runtime loader does not 
have this feature, it is necessary to bind object files with the 
code included. 


21.2.2 New switches 


A previously undocumented switch for MakeBoot: 

/u Utility Pilot bootfile: the resulting bootfile is a Utility 
Pilot client. 

A new switch for MakeBoot: 

Ic Code Links: use code links when possible when the object 
files are loaded. The default is false, and frame 
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links are used. Frame links are preferable for modules 
that have global frames outside the mds. 


21.2.3 Parameter file 


The parameter file can contain the following new entries: 

GFT: number, 

allow number of entries in the global frame table, gft is the 
maximum number of modules that can be loaded with the 
resulting bootfile. This number include the MakeBoot loaded 
modules and the runtime loaded modules. 

gftbase: number; 

set the base of the global frame table at page number. 
localframepages: number; 

sets the size of the the local frame heap to number pages. The 
default value for localframepages is 50. 


24 Debugger 


See the XDE User's Guide - New chapter - Debugger portion 
of this change summary. 


28 Performance tools 


The performance tools have changed to use Sword interfaces 
instead of CoPilot interfaces. The performance tools may only 
be used with an outload or remote debugging session; "same 
world" performancetoolsare not available. 


28.1.5 Getting started 


The debugging session must be created before running the 
performance tool. If another outload or remote debugging 
session is started after the performance tool is run, it should be 
started with the -s switch (see the section on DebugllsefulDefs 
in the new XUG Debugger chapter). If the debugging session 
ends, the performance tool should be deactivated. 
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